Skip to content

fix(spec): add GET drives/{drive-id}/items/{item-id}/children#43

Open
dschmidt wants to merge 1 commit into
opencloud-eu:mainfrom
dschmidt:feat/list-children
Open

fix(spec): add GET drives/{drive-id}/items/{item-id}/children#43
dschmidt wants to merge 1 commit into
opencloud-eu:mainfrom
dschmidt:feat/list-children

Conversation

@dschmidt
Copy link
Copy Markdown
Contributor

@dschmidt dschmidt commented May 11, 2026

Summary

Adds the spec entry for the existing GET /v1.0/drives/{drive-id}/items/{item-id}/children endpoint, which has been implemented as GetDriveItemChildren (services/graph/pkg/service/v0/driveitems.go:285) but had no matching OpenAPI definition. Generated clients (libre-graph-api-go, -typescript-axios, etc.) will pick up a typed method for listing children of a non-root item.

Response shape mirrors the existing HomeGetChildren operation: a Collection-of-driveItems object with value[] and an optional @odata.nextLink.

The description also acknowledges the MS Graph colon-syntax URL forms (/root:/{path}:/children and /items/{item-id}:/{path}:/children) the server accepts via the path-lookup middleware - OpenAPI cannot express the colon-delimited path segment, so they aren't separate operations but are documented inline.
It's not supported yet, but will be when opencloud-eu/opencloud#2688 is merged.
Changes in this repo usually predate the implementation in the server, so imho it's fine (although fix in the title becomes debatable then ... :))

The handler GetDriveItemChildren at
services/graph/pkg/service/v0/driveitems.go:285 has existed for a while
but was undocumented. Add the matching spec entry so generated clients
expose a typed method for listing children of a non-root item.

Mirrors the response shape of the existing HomeGetChildren operation
(a Collection-of-driveItems object with value[] and an optional
@odata.nextLink), and acknowledges the MS Graph colon-syntax URL forms
the server accepts via path-lookup middleware.
@dschmidt dschmidt changed the title feat(spec): add GET drives/{drive-id}/items/{item-id}/children fix(spec): add GET drives/{drive-id}/items/{item-id}/children May 11, 2026
@dschmidt dschmidt force-pushed the feat/list-children branch from 24f55f5 to 5222cb6 Compare May 11, 2026 15:01
@dschmidt dschmidt marked this pull request as ready for review May 11, 2026 15:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant